pp108 : Installing and Configuring ActiveMQ

Installing and Configuring ActiveMQ
This topic describes the procedure to install and configure ActiveMQ.

ActiveMQ, designed by the Apache software foundation, is an open source Java Message Service (JMS 1.1. compliant) that provides high reliability, performance and scalability, and ensures secured enterprise messaging. This topic describes the basic installation procedure to use ActiveMQ as an integrated messaging platform for Process Platform. Enterprise deployment of ActiveMQ is not in the scope of this topic. For more details, see activeMQ documentation.

Software requirements

You must install the following software before configuring ActiveMQ:

  • Queueing server: Apache ActiveMQ 5.6.0

Installing and starting ActiveMQ in Linux

  1. Download apache-activemq, apache-activemq-5.6.0-bin.tar.
  2. Create the directory /opt/Apache.
  3. Extract the ActiveMQ TAR file to this directory - /opt/Apache: (tar zxvf apache-activemq-5.6.0-bin.tar).
  4. Go to the configuration file /opt/Apache/apache-activemq-5.6.0/conf/activemq.xml and change the JMX port used within ActiveMQ. Modify managementContext as follows:
    <managementContext>
    <managementContext connectorPort="1199" createConnector="true"/>
    <managementContext>

    Note: The default JMX port for ActiveMQ, which is 1099, is also the default port for Process Platform installation.

  5. Go to the directory /opt/Apache/apache-activemq-5.6.0/bin and start ActiveMQ with ./activemq start.
  6. Now, the ActiveMQ admin console can be accessed with the URL http://<hostname>:8161/admin/.

Installing and starting ActiveMQ in Windows

  1. Download apache-activemq, ActiveMQ 5.6.0 Windows distribution.
  2. Create a directory C:\Program Files (x86)\Apache\activeMQ.
  3. Extract the ActiveMQ TAR file to this directory using an unzip utility.
  4. Modify the JMX port in the file C:\Program Files (x86)\Apache\ActiveMQ\conf\activemq.xml as described in step 4 of the above section.
  5. Start Activemq with activeMQ.bat found in C:\Program Files (x86)\Apache\activeMQ\bin. Alternatively, you can also start ActiveMQ as a windows service; For more details, see the ActiveMQ website.
  6. Now, the ActiveMQ admin console can be accessed with the URL http://<hostname>:8161/admin/.

    Note: No additional or manual steps are needed within ActiveMQ. When a JMS endpoint is created, queues are automatically created within ActiveMQ.